home *** CD-ROM | disk | FTP | other *** search
- This is what I consider the first official release of Emacs 18.57
- for the Atari ST. It is distribution 2 because an earlier beta version (D1)
- was floated to uncover bugs, and because some people could not wait for
- me (I am very slow). This version is improved in a number of ways so I suggest
- using it, and trashing copies of the earlier version. Many people have made
- this port usable. (j. bammi, a. pratt, e. roeder, e. smith, f. ridderbusch,
- l. lasser, to name a few...)
-
- There are 2 archive files that are of relevance,
-
- 1. 1857bin-d2.zoo- The binaries for emacs, some binary utilities
- for dumping and setting the value of _initial_stack,
- and all the basic emacs lisp files necessary to
- create a working ST/TT version of GNU-EMACS 18.57!
-
- 2. 1857src-d2.zoo- The source code for the above described emacs, and
- the related utilities along with a makefile,
- and a ChangeLog file that documents all changes
- to the original FSF GNU-EMACS 18.57 distribution.
-
- Merits of this port:
-
- [a] Works with TOS/MiNT, MiNT pre 0.92 requires an "stty raw"
- command prior to invoking emacs
-
- [b] Allows Shell command to be run from within emacs with the
- output automatically put into an emacs buffer
-
- [c] Allows Shell escape (^Z), this spawns a new shell whether MiNT
- is present or not. This was the most pleasing overall solution
- to shell-escapes that I could think of in a single/multi tasking
- environment.
-
- [d] Allows a dumped emacs with all startup code preloaded.
-
- [e] Runs on any ST or TT with a minimum of 1024k of memory.
- -- --
- [f] If one has enough free memory, (1.2 meg is a working minimum)
- one can run the wonderful GNU-CALC, calculator/symbolic math
- package, available from prep.ai.mit.edu
-
- [g] Supports UNIXMODE long filenames/links free of charge
-
- [h] Supports display of 8-bit characters in any buffer provided the
- local variable "ctl-arrow" is set to something other than
- "T" or "nil". (see emacs.rc)
-
- -------------------------------------------------------------------------------
- Binary Installation:
-
- How to go about dumping an ST/TT version of EMACS 18.57!
-
- The file 1857bin-d2.zoo contains the following directories and files.
-
- 1. ./lisp/ - the relevant (useful to me) e-lisp files.
- some of these are absolutely required for
- dumping an emacs.
-
- ./lisp/term/atari.el - The Atari Keyboard Mapping file
- [see also ./emacs.rc]
-
- 2. ./etc/ - contains the emacs DOC string file and a
- sample termcap file.
-
- 3. ./bin/ - contains [a] temacs - undumped raw emacs
- [b] dumpfix.ttp - dumping program from (er)
- [c] dumpemac.ttp - f. riderbusch's automated
- dumper program
- [d] printstk.ttp - show current emacs stack
- [e] fixstk.ttp - set current emacs stack
-
- 4. ./emacs.rc - a sample ST emacs initialization file.
- this file is very important as it loads the
- ST key bindings.
-
- DUMPING EMACS,
-
- 0. set the environment variable UNIXMODE to the string "/.,rCLAHbd",
- on my system with BASH1.10 I do the following,
-
- export UNIXMODE="/.,rCLAHbd"
-
- 1. extract 1857bin-d2.zoo via "zoo x.// 1857bin-d2.zoo"
-
- 2. set the environment variables,
- EMACSLOADPAH, EMACSLIB, EMACSDOC to ./lisp, ./lisp, ./etc respectively.
- on my system with BASH1.10 I do the following in my .bashrc file,
-
- export EMACSLOADPATH=/dev/F/bin/emacs/lisp
- export EMACSLIB=/dev/F/bin/emacs/lisp
- export EMACSDOC=/dev/F/emacs/etc
-
-
- 3. cd to ./bin
-
- Decide on how much space (stack) you want emacs to take up. This
- is a system based decision.
-
- [a] If you never want to run a really large emacs package
- such as gnu-calc, then a stack value of 512k is
- appropriate for your emacs.
-
- [b] If you want to run a gnu-calc or some other huge
- emacs-lisp application, a value such as 2048k or
- -1L (all memory) may be good for you.
-
- The catch is if you make the stack -1L and get all memory then
- it is impossible to shell out or to run shell-command in an emacs
- window. (unless one uses MiNT where a stack value of -1L works
- perfectly since one may launch emacs with a "limit" command.)
-
- If this make no sense to you, do not worry, just skip the next
- set of instructions (about changing the stack size) and keep
- the default stack size, (512k).
-
- 4. Change the stack size with the fixstk.ttp utility that is included.
-
- ./fixstk <stack size> temacs - this reports previous and new
- sizes.
-
- 5. execute the "dumpemac.ttp" file, I do a :
-
- ./dumpemac
-
- watch the program build a nice dumped version of emacs.
-
- RUNNING EMACS,
-
- 1. You must have the variables mentioned in 2, under dumping emacs, set
- correctly.
-
- 2. create an alias for running emacs like the following,
-
- alias emacs="/dev/F/bin/emacs/bin/xemacs.ttp -q -l /dev/F/.emacs"
- \______________/
- |
- this is your
- custom init file.
-
- a good choice for the ".emacs" file is the included "emacs.rc" file.
-
- 3. set the environment variable TERMCAP to point to your "termcap" file,
- set the environment variable TERM to be a valid terminal entry in
- the above TERMCAP file.
-
- 4. just saying "emacs" should work fine now! (because of the dumping process
- a reboot may be required.)
-
- -------------------------------------------------------------------------------
-
- To work with the source, extract using zoo v2.1 via "zoo x.// 1857src-d2.zoo"
- to produce the following directory tree :
-
- source/
- lib+/
- utils/
-
- The source/ and source/utils directories have their own makefiles, the
- source/lib+ directory contains some library support necessary for building a
- temacs. Everything should be self explanatory :), see the file ChangeLog
- if you are interested in the details. By the way all changes to the
- original source are marked by conditional defines, (atarist), and have
- some form of descriptive comment in place.
-
- -------------------------------------------------------------------------------
-
-
-
- BUGS, COMMENTS, PRAISE, ;-) etc....
-
- scott@sparc1.stevens-tech.edu
-
- scott kolodzieski
-
- PS. I cannot give enough praise to the people mention in the beginning of this
- file, for without those this would never have happened.
-
-
-
-